home *** CD-ROM | disk | FTP | other *** search
/ InterCD 2001 March / march_2001.iso / intercd / root / ^Palm / Internet / palmtelnet-0.41 / readme.txt < prev   
Encoding:
Text File  |  1998-03-04  |  11.0 KB  |  268 lines
  1. PalmTelnet 0.41
  2. ---------------
  3.  
  4. PalmTelnet is a Telnet Client / Terminal Emulator for PalmOS.
  5.  
  6. Since it is in the initial development stages,
  7. it is still missing some features and may contain some bugs.
  8.  
  9. PalmTelnet is distributed as freeware but is not in the public domain.
  10. PalmTelnet is Copyright (c) 1997,1998 Marcio M. Andrade.
  11.  
  12. The software can not be reverse engineered or modified in any way
  13. (including this readme). To include PalmTelnet in any software collection,
  14. online or not, first contact the author for permission.
  15.  
  16. This software comes with absolutely NO warranty, so use it at your own risk.
  17.  
  18. Send comments or suggestions to this email address: mar@sis.dcc.ufmg.br
  19. The PalmTelnet Home-Page is located at:
  20. http://www.sis.dcc.ufmg.br/~mar/pilot/palmtelnet/
  21.  
  22. Regards,
  23.  
  24.   Marcio Migueletto de Andrade
  25.   mar@sis.dcc.ufmg.br
  26.  
  27. --
  28.  
  29. Requirements:
  30.  - Telnet Client: PalmPilot Professional.
  31.  - Other features: PalmPilot Personal or Professional.
  32.  
  33. Features:
  34.  - RFC 854 Telnet protocol (telnet mode).
  35.  - RS-232 connection up to 57600 bps (serial mode).
  36.  - VT100 terminal emulation.
  37.  - 5x9 fixed font (ISO 8859-1), or 4x6 fixed font (7-bit ASCII).
  38.  - Screen sizes: 16x32, 16x64, 24x40 or 24x80.
  39.  - Configurable string macros (including ESC and control characters).
  40.  
  41. What is new in 0.41 (see History Log below for past releases):
  42.  - Three views of wide screens: left, middle and right.
  43.  - It is possible to send all 32 lower ASCII codes (0-31) using "Ctl" button.
  44.  - It is possible to insert control characters in macros.
  45.  - Fixed a few bugs in the VT100 emulation.
  46.  - Fixed the "Prompt" bug in the Service connection dialog. In previous
  47.    versions, if you left the Password unassigned or had a Prompt field in the
  48.    Service script, PalmTelnet would crash with a "Fatal Exception".
  49.  - Fixed the "Alarm Popup" bug. In previous versions, if an alarm went off
  50.    while PalmTelnet was running it would crash with a "Fatal Exception".
  51.  
  52. Known bugs:
  53.  - PalmTelnet "Kbd" button is not compatible with SymbolHack 1.0 or below.
  54.    You have to disable the hack if you want to use the built-in keyboard in
  55.    the main screen. In the Macros and Network forms SymbolHack works fine.
  56.    The "Kbd" button works with SymbolHack 1.1 though. Also the keyboard "dots"
  57.    in the Graffiti area don't work.
  58.  - There seems to be a conflict with CorrectHack. As reported by other users:
  59.    sending a return causes a fatal exception.
  60.  
  61. Upgrading from previous versions:
  62.  - If you are using 0.4b (not a public available distribution), you must delete
  63.    it first and then install 0.41.
  64.  - Otherwise just install 0.41.
  65.  - To make sure what version you have, choose Menu / About.
  66.  
  67. Operation:
  68.  - In Terminal Options, choose operation mode: telnet or serial. In
  69.    telnet mode, PalmTelnet uses the built-in TCP/IP stack. In serial mode,
  70.    it uses the serial port directly.
  71.  - If using telnet mode, enter a host and a port in Network Options and tap
  72.    the "On" button on the lower left corner.
  73.    Before connecting to the host, PalmTelnet will start the TCP/IP stack
  74.    by activating the service defined in PalmOS Prefs/Network (if it is
  75.    not already started).
  76.    If the connection is successful, the "On" button will turn black,
  77.    otherwise it will remain blank and an error message will be displayed.
  78.    Possible reasons for failing are: DNS lookup failure, host is unreachable,
  79.    timeout, etc. You can configure the timeout (in seconds) for DNS lookup and
  80.    connection.
  81.  - If using serial mode, configure the baud, parity, word size, stop bits and
  82.    flow control in Serial Options and tap the "On" button on the lower left
  83.    corner. PalmTelnet will then open the serial port.
  84.    If the connection is successful, the "On" button will turn black,
  85.    otherwise it will remain blank and an error message will be displayed.
  86.  - To disconnect from the host, either logout or tap the "On" button again.
  87.    In telnet mode, note that the TCP/IP stack will NOT be shut down.
  88.    To do this, go to the PalmOS Prefs/Network and disconnect. In serial mode,
  89.    after logout you have to tap the "On" button to really disconnect.
  90.  - Once connected, all other features are exactly the same, regardless of
  91.    the mode choosen.
  92.  
  93.  - The cursor position is marked by a fixed underscore (if disconnected) or a
  94.    blinking underscore (if connected) in the screen.
  95.  - To send characters, simply write them in the Graffiti area.
  96.    You can also tap the "Kbd" button, which will bring up the built-in keyboard.
  97.    After tapping "Done", the characters you have typed will be sent (max. 64). 
  98.    Note that there is no editable text field on the screen, so every time
  99.    you call the keyboard it will NOT edit the current line, and will start
  100.    empty.
  101.    If you type the sequence "\r" (without quotes) in the keyboard panel,
  102.    PalmTelnet will send the "return key" you chose in Terminal options.
  103.    The sequence "\\" sends a single "\".
  104.    The sequence "\^" sends a "^".
  105.    Naturally, you can also use Graffiti ShortCuts to send text.
  106.  - To send control characters, tap the "Ctl" button and write one of the
  107.    characters in the table below. Tapping "Ctl" without writing a character
  108.    will deactivate the "control state".
  109.  
  110.    Character    ASCII code sent (decimal)
  111.    ---------    -------------------------
  112.    @        00
  113.    A..Z        01..26
  114.    a..z        01..26
  115.    [        27
  116.    \        28
  117.    ]        29
  118.    ^        30
  119.    _        31
  120.  
  121.  - Shift and Caps lock are the same as in Graffiti.
  122.  - To send an ESC, tap the "Esc" button (or tap "Ctl" and write "[").
  123.  - To send one of the six configurable macros, select the "Macros" listbox
  124.    and choose the macro name. The macro definition will be sent.
  125.  
  126.  - If you are connecting to a Unix host and are using the serial mode, check
  127.    that your terminal is set to VT100 (set term=vt100, if csh, or TERM=vt100,
  128.    if sh) and that the screen is the correct size: stty rows <number-of-rows>
  129.    cols <number-of-cols>).
  130.    Better yet, put this commands in a shell script and create a macro in
  131.    PalmTelnet that executes this script.
  132.    If you are using the telnet mode, the terminal type and the window size 
  133.    are automatically configured.
  134.  - If choose 80/64 for screen width, you still can see only 40/32 columns
  135.    at a time.
  136.    To view the left 40/32 columns, tap on left of the screen.
  137.    To view the middle 40/32 columns, tap on middle of the screen. You will be
  138.    seeing columns 20 to 59 (or 16 to 48).
  139.    To view the right 40/32 columns, tap on right of the screen.
  140.    If you choose 40/32 for screen width, tapping on the screen will have no
  141.    effect.
  142.    It is better to change the screen size before you run a program that
  143.    relies on it (like vi, pine, lynx, etc), or it may get confused.
  144.  - These hardware buttons generate the following VT100 key codes:
  145.    PageUp: up-arrow
  146.    PageDown: down-arrow
  147.    Date Book: space
  148.    Address Book: left-arrow
  149.    Todo List: right-arrow
  150.    Memo Pad: return key
  151.    If your terminal is set properly, programs like vi, pine, lynx, etc
  152.    recognize these key codes.
  153.  
  154. Options:
  155.    PalmTelnet has five menu options:
  156.  
  157.  - Network (applicable only to telnet mode):
  158.    Enter a host name or IP address and a port number (decimal).
  159.    Configure the timeout (in seconds) for DNS lookup and connection.
  160.    Every time you tap the "On" button, PalmTelnet will try to
  161.    connect to this port on this host.
  162.  
  163.  - Serial (applicable only to serial mode):
  164.    Configure the baud, parity, word size, stop bits and flow control.
  165.  
  166.  - Terminal:
  167.    Choose the operation mode: telnet or serial. If you are using a PalmPilot
  168.    Personal, the telnet mode will be disabled.
  169.    Choose what kind of "return key" you are using: when you write a
  170.    Graffiti return, PalmTelnet will send a CR, a LF or both.
  171.    Choose the screen size (by choosing the width): 16x32, 16x64, 24x40 or 24x80.
  172.    The first two sizes use a 5x9 font and the other two use a 4x6 font.
  173.    One drawback of the 4x6 font is that it is just 7-bit ASCII, so you won't
  174.    be able to see the ISO 8859-1 international characters (it shows a white
  175.    space instead). If your choice changes the current font, the screen will
  176.    be erased.
  177.    Checking "Local echo" will make PalmTelnet echo locally every
  178.    character you write.
  179.  
  180.  - Macros:
  181.    In the left column, you choose up to six macro names (max. 8 chars).
  182.    These names are shown in the "Macros" listbox in the bottom of the main
  183.    screen.
  184.    In the right column, you choose their definitions (max. 20 chars).
  185.    If you insert the sequence "\r" (without quotes) in the macro definition,
  186.    PalmTelnet will send the "return key" you chose in Terminal options.
  187.    The sequence "\\" sends a single "\".
  188.    The sequence "\^" sends a "^".
  189.    If you insert the sequence "^x" (without quotes) in the macro definition,
  190.    where x is any character in the table shown above, PalmTelnet will send the
  191.    corresponding ASCII code.
  192.    Common uses for macros are: login names, passwords, terminal
  193.    configuration commands, logout command, etc.
  194.    Here is an example of a useful set of macros for a user that has
  195.    a csh account on a Unix machine:
  196.  
  197.    Name        Definition
  198.    -----------    ---------------
  199.    Login    mylogin\r
  200.    Password    mypasswd\r
  201.    Init        source .pilot\r
  202.    Logout    logout\r
  203.    Mail        pine\r
  204.    Web        lynx\r
  205.  
  206.    In this example, the .pilot file could have these lines:
  207.    stty sane
  208.    stty erase ^H
  209.    stty rows 24 cols 80
  210.    set term=vt100
  211.   
  212.  - About: About box.
  213.  
  214.  
  215. History log:
  216.  
  217.  Version 0.1 (97-10-13), initial release:
  218.    - RFC 854 Telnet protocol.
  219.    - VT100 terminal emulation (almost complete).
  220.    - 5x10 fixed character font.
  221.    - 32 columns x 15 lines screen.
  222.    - Configurable string macros.
  223.  
  224.  Version 0.2 (97-10-19):
  225.    - Configurable screen width: 32 or 64 columns.
  226.    - Reverse video (VT100).
  227.    - Hardware buttons generate VT100 up-arrow, down-arrow, right-arrow and
  228.      left-arrow key codes.
  229.    - Error messages.
  230.    - Corrected a bug that caused a connection to fail sometimes.
  231.    - Corrected a bug that caused a fatal exception in the Macros form.
  232.  
  233.  Version 0.21 (97-10-19):
  234.    - Corrected a bug that caused a fatal exception everytime a connection
  235.      failed.
  236.  
  237.  Version 0.22 (97-10-25):
  238.    - Added a standard Edit menu (Copy, Paste, Keyboard, Graffiti, etc) to
  239.      these forms: Macros, Network.
  240.    - Added Graffiti State Indicator to these forms: Main, Macros, Network.
  241.    - Better VT100 support (now works with elm).
  242.  
  243.  Version 0.3 (97-11-03):
  244.    - ISO 8859-1 character set.
  245.    - Minor changes in the character font.
  246.    - Ability to send characters using the built-in keyboard.
  247.    - Faster startup.
  248.    - Fixed a bug in VT100 emulation.
  249.    - Fixed a bug that made the Graffiti State Indicator disappear sometimes.
  250.  
  251.  Version 0.31 (97-11-11):
  252.    - Implemented VT100 Scrolling Regions: now PamlTelnet works correctly with
  253.      ircII client on UNIX !
  254.  
  255.  Version 0.4 (98-02-07):
  256.    - Dual mode operation: telnet or serial.
  257.    - Added a new form: Serial Options.
  258.    - Changed the current font from 5x10 to 5x9, giving 16 lines.
  259.    - Added a new font (4x6), giving two new screen sizes: 24x40 and 24x80.
  260.    - Configurable timeouts for telnet mode.
  261.    - Now uses all six hardware buttons.
  262.    - Blinking cursor.
  263.    - Fixed a few bugs in the VT100 emulation.
  264.  
  265. --
  266.  
  267. 3Com, PalmOS, PalmPilot and Graffiti are service marks of 3Com Corporation.
  268.